home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr40 / x1j4pk96.zip / README.TXT < prev    next >
Text File  |  1995-01-28  |  13KB  |  345 lines
  1.  
  2. TheNet X-1J release 2 read.me file                               Page 1
  3.  
  4. This disk contains the distribution version of TheNet X-
  5. 1J release 4.
  6.  
  7. 1. Hardware Requirements
  8.  
  9.      The  software runs in a Z80 based TNC2  or  similar
  10.      clone  such  as  the  BSX2.  It  is  installed   as
  11.      described   in  the  bankswitch  mods   file,   but
  12.      essentially all it needs is a single piece of  wire
  13.      from pin 8 of the modem disconnect header to pin  1
  14.      of the EPROM.
  15.      
  16.      There is also a version for the PK96 that needs  no
  17.      bankswitch  mods but may need change for  the  DCDB
  18.      select on pin 23
  19.      
  20.      The  EPROM needed is a 27512, rather than the 27256
  21.      of  a  normal TNC2. Pin 1 of the EPROM is bent  out
  22.      from the socket and connected as described above.
  23.      
  24.      The  TNC2 needs to be set to the higher clock speed
  25.      of  4.9  MHz  as a minimum. Whilst this version  of
  26.      TheNet  is  more efficient than others, it  is  not
  27.      sensible to run at the slower speed.
  28.      
  29.      The TNC needs at least 32K bytes of RAM. If a PK96
  30.      is used with extra RAM only 32 K will be used.
  31.      
  32.      The TNC needs to have DCDB from the SIO/0 connected
  33.      to  pin  23 of the RS232 connector. See the section
  34.      on RS232 later in this note for more information.
  35.      
  36. 2. Installing over TheNet X previous versions
  37.  
  38.      If  you are replacing a previous ROM with TheNet in
  39.      it,  be  sure to do a coldstart ( you may  need  to
  40.      remove the battery link to force this ).
  41.      
  42. 3. Files
  43.  
  44.      The files on this disk are :
  45.      
  46.           thenet1.x1j    Part 1 of the code
  47.           thenet2.x1j    part 2 of the code
  48.           readme.*       This file
  49.           configur.*     Installation guide
  50.           userguid.*     A user's guide to the node
  51.           overview.*     The sysop's manual
  52.           quickref.*     A handy quick reference guide
  53.           bankswit.*     Information on the hardware bankswitching
  54.           intro.*        The brief release note
  55.           smeter.*       Details on the Smeter hardware
  56.           devmeter.*     Details on the deviation meter
  57.           patch.exe      A windowing driven patcher
  58.           intel.exe      An Intel hex file dump utility
  59.           intel.c        The source of the above
  60.           motorola.exe   A Motorola S1 type file dumper
  61.           motorola.c     The source of the above
  62.           sethelp.exe    Utility to change the ROM help text
  63.           sethelp.c      The source of the above
  64.           printpwd.exe   Utility to print a password nicely
  65.           printpwd.c     The source of the above
  66.           smeter.csv     Sample data for smeter calibration
  67.           smeter.ljt     Circuit for an S meter in HPPCL format
  68.           ipxlink.doc    Ideas on node IP addressing
  69.           x1jconv.c      Source for x1jconv.exe
  70.           x1jconv.exe    Utility to help manage node configuration
  71.           x1jconv.txt    Documentation for x1jconv.exe
  72.           thenetx.hlp    Windows 3.1 Help file of main documents
  73.           
  74.     The files denoted '*' are stored in two formats
  75.     
  76.     .TXT    ASCII versions of the files
  77.     .DOC    Word for Windows 2.0 format
  78.     
  79.     The files contain the same except for the DEVMETER
  80.     and SMETER, as the ASCII version does not contain
  81.     the circuit diagrams or graphs. The smeter circuit
  82.     diagram is shown in laserjet printer format ( i.e.
  83.     HPPCL ) in the file smeter.ljt. As this is a large
  84.     file, it has been compressed into the zip file
  85.     smeter.zip.
  86.     
  87.     The file thenetx.hlp is a MS Windows 3.1 help file.
  88.     Whilst running windows, open file manager, select
  89.     the file and either run it or drag it to the
  90.     desktop to create an Icon under windows that
  91.     contains most of the main documentation.
  92.     
  93. 4. Using it with a TCP/IP system
  94.  
  95.      One  of  the reasons for the inclusion  of  the  IP
  96.      router  was to help the development of IP networks.
  97.      This is in two different ways :
  98.      
  99.        It  allows a IP station that does not  run  24
  100.        hours  to run an IP router for the others in  the
  101.        area without leaving the PC running,
  102.  
  103.        It allows existing nodes to double as IP routers.
  104.  
  105.      In  scenario 1, where a station runs a  TNC2  clone
  106.      with  a  KISS ROM or similar, this software may  be
  107.      used  instead  of  the  KISS  ROM.  It  should   be
  108.      configured to run KISS, Selective Copy on the RS232
  109.      port.
  110.           
  111. 5. The other version
  112.  
  113.      The version that includes the HIGH and LOW commands
  114.      is   not   included  here.  It  used  a   form   of
  115.      bankswitching  that  clashes  with  the   deviation
  116.      meter.
  117.      
  118. 6. Problems
  119.  
  120.      One of the main problems with release 2 was the
  121.      loss of buffers over time. It was cured by a fault
  122.      in the L2 receive handler when a reject frame was
  123.      sent on connect establishment. In this case the
  124.      receive buffer was not released. This has been
  125.      cured.
  126.      
  127.      One  common problem. If your node appears to 'lose'
  128.      nodes,  look  very carefully at the rates  of  node
  129.      broadcasts   and  the  setting  of  the   algorithm
  130.      control.  The RS232 rate should be faster than  the
  131.      radio  rate  or it should be set to zero,  and  the
  132.      alternative algorithm should only be enabled on the
  133.      RS232  port if at all. Try switching it off to  see
  134.      if that helps.
  135.      
  136.      The patcher has been altered. The code now comes as
  137.      two  parts and the patcher patches both at the same
  138.      time. It needs & expects to be able to access  both
  139.      parts.
  140.      
  141. 7.   RS232 connections
  142.  
  143.      It is important that you understand the RS232
  144.      connections.
  145.      
  146.      The  RS232  port will operate in one of  two  basic
  147.      modes,  a  dumb terminal mode and a protocol  mode.
  148.      Each  of  these  modes  has  two  basic  types   of
  149.      operation. These are detailed further below.
  150.      
  151.      The  decision  as to whether the node  operates  in
  152.      dumb  terminal  or  protocol mode  depends  on  the
  153.      setting   of   the  DCDB  input   of   the   serial
  154.      communications chip ( the SIO/0 ). In TNC2  clones,
  155.      this   is  the  signal  on  pin  23  of  the  RS232
  156.      connector, but in most TNCs you will need to either
  157.      insert  a  link or a piece of wire, as detailed  in
  158.      your  TNC  manual. After connecting  the  links  if
  159.      needed, then leaving pin 23 open circuit will cause
  160.      the  TNC  to  operate  in dumb terminal  mode,  and
  161.      setting it to a negative voltage ( ie connecting it
  162.      to  pin  10 ) will cause it to operate in  protocol
  163.      mode.
  164.      
  165.      If  you use a BSX2 TNC, then you should connect pin
  166.      23  to  pin 7 rather than pin 10 for protocol mode.
  167.      You  will also need to insert a link into  JMP14  &
  168.      make sure there is no jumper in JMP9.
  169.      
  170.      If you use one of the other common TNC2 clones such
  171.      as   the   PK80,  MFJ1270,  TNC-200  etc,  then   I
  172.      understand  (  but cannot confirm ) that  you  will
  173.      need  to connect a wire from JMP9 pin 1,2  or  3  -
  174.      they are all joined on the PCB - to RS232 pin 23.
  175.      
  176.      Incidentally, don't forget to increase the watchdog
  177.      timer capacitor to give a 1 minute timeout ( C31 to
  178.      47uF in TNC2 clones ).
  179.      
  180.      Finally, the protocol modes are CROSSLINK or  KISS,
  181.      selected  by  the firmware, and the  dumb  terminal
  182.      modes are STANDARD or MODEM, again set by firmware.
  183.      In the MODEM mode, hardware handshaking is used for
  184.      connect request / disconnect. This is NOT the usual
  185.      method  of  operation. Unless you are  certain  you
  186.      understand, DO NOT use this mode !.
  187.      
  188.      If  you  use the PK96 there are some problems  with
  189.      the  RS232 port. See the text in the overview guide
  190.      for details.
  191.      
  192. 8. Introduction to nodes
  193.  
  194.      If  you have not used a TNC based node before,  the
  195.      following  notes  on  the operation  of  the  'dumb
  196.      terminal' port may be of use.
  197.      
  198.      When  pin  23 on the RS232 interface is  high,  and
  199.      with  a terminal or terminal emulator on the  RS232
  200.      port,  the  node  will  not appear  to  respond  to
  201.      anything.  If  you send an 'escape' character,  the
  202.      node  should respond with a '* '. If it  does  not,
  203.      look at the TNC status LED. It should be dimly  lit
  204.      with a little bit of a flicker. If not, the node is
  205.      not operating. If it is, you have an RS232 problem.
  206.      If you receive unsolicited garbage whenever the TNC
  207.      receives data, you have pin 23 tied low and you are
  208.      receiving crosslink or kiss frames.
  209.      
  210.      If it does respond with a star and a space, you can
  211.      now type one of 3 characters - C, D or P.
  212.      
  213.      P will display or set the current password.
  214.      D will disconnect you from the node.
  215.      C will connect you to the node.
  216.      
  217.      Try  the  C  command. You should get a  'connected'
  218.      message.  Hit '?' followed by return and  you  will
  219.      get a list of all commands.
  220.      
  221.      Escape commands only work on the RS232 port when in
  222.      dumb terminal mode. Don't forget to disconnect from
  223.      the node before you disconnect the terminal.
  224.      
  225.      The  main  documentation details the  new  commands
  226.      added  to  the original TheNet 1.01.  It  does  not
  227.      cover  the original commands unless they have  been
  228.      changed. The commands of interest are :
  229.           
  230.           Connect
  231.           Node
  232.           Route
  233.           User
  234.           CQ
  235.           Parms
  236.           Sysop
  237.           Info
  238.           Reset
  239.      
  240.      These  are  described  in  user  guide,  with   the
  241.      exception  of  the Sysop aspects of  the  commands.
  242.      These are as follows :
  243.      
  244. 8.1 Node
  245.  
  246.      The Node command may be used to make a manual entry
  247.      in  the  Net/Rom node table. When this is done,  it
  248.      may  also  make  an entry in the  routes  table  if
  249.      necessary. The syntax of the command is :
  250.      
  251.      NODE Callsign + Ident Quality Count Port Neighbour
  252.      
  253.      callsign is the callsign of the destination node
  254.      ident is the alias of the destination node
  255.      Quality is the node quality for the entry
  256.      Count is the obsolescence count to be given to  the
  257.      entry
  258.      Port is the level 2 port ( 0 for radio, 1 for RS232
  259.      )
  260.      Neighbour is the callsign of the neighbouring  node
  261.      to route through
  262.      
  263.      So  to  make  an  entry that will never  expire  to
  264.      ANODE:G8KBB-1  where the node is accessed  directly
  265.      on the radio port with a quality of 123, enter
  266.      
  267.      NODE G8KBB-1 + ANODE 123 0 0 G8KBB-1
  268.  
  269.      If  the  same station is not heard directly but  is
  270.      accessed through node GB7TXM-2 over the radio,  and
  271.      the  entry will expire when its obsolescence  drops
  272.      to zero from an initial count of 8, enter :
  273.      
  274.      NODE G8KBB-1 + ANODE 123 8 0 GB7TXM-2
  275.  
  276.      An  entry  may be deleted by substituting  '-'  for
  277.      '+'.
  278.  
  279. 8.2 Route
  280.  
  281.      The  routing  table tells the node  the  routes  to
  282.      neighbouring nodes. It can also be used to  make  a
  283.      manual entry as follows :
  284.      
  285.      ROUTE Port Callsign [ Digilist ... ] + pathquality
  286.  
  287.      Port  is the AX.25 port number, 0 for radio  and  1
  288.      for RS232
  289.      Callsign is the neighbouring node's callsign
  290.      
  291.  
  292. 8.3 Parms
  293.  
  294.      The  PARMS  command  sets a number  of  basic  node
  295.      parameters.  See the quick reference  guide  for  a
  296.      list of them.
  297.  
  298. 8.4 Sysop
  299.      
  300.      Sysop is used to attain Sysop status. The node will
  301.      challenge with 5 numbers. These are used to look up
  302.      the  corresponding password characters in the Sysop
  303.      password  table. This password is returned  to  the
  304.      node  on  the next line. The password is stored  in
  305.      the  ROM  and  is  copied  into  RAM  following   a
  306.      coldstart.  From a locally connected  terminal  the
  307.      password  may  be displayed or changed.  using  the
  308.      <escape>P command.
  309.      
  310. 9. 'User channel' nodes
  311.      
  312.      To  create  a  'user channel' node (  ie  one  that
  313.      supports  Net/Rom protocols on its RS232  port  but
  314.      not on its Radio port ), do the following :
  315.      
  316.           Set the radio port default quality to one less
  317.        than minqual
  318.            Bar  node  broadcasts on the  radio  port  by
  319.        setting MODE parameter number four to 2
  320.            Ensure  that  no manual routes exist  in  the
  321.        route table for port 0.
  322.      
  323. 10. EADG Nodes
  324.      
  325.      If  you  put a node up in the UK that can be  heard
  326.      from  East Anglia, may I encourage you to  put  the
  327.      QRA  locator in the Beacon text to enable the G1TLH
  328.      Beacon  analysis  program to report  accurately  on
  329.      propagation conditions.
  330.      
  331.      
  332. 73's
  333.  
  334. Dave G8KBB @ GB7MXM.#36.GBR.EU
  335. [44.131.16.31] g8kbb@g8kbb.ampr.org
  336.  
  337. 7, Rowanhayes Close
  338. Ipswich
  339. IP2 9SX
  340. England
  341.  
  342. Tel    0473 682266
  343.     +44 473 682266
  344.  
  345.